home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3g / str.z / str
Encoding:
Text File  |  2002-10-03  |  5.5 KB  |  66 lines
  1.  
  2.  
  3.  
  4. ssssttttrrrr((((3333GGGG))))                                                                ssssttttrrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_tttt_rrrr: _ssss_tttt_rrrr_ffff_iiii_nnnn_dddd, _ssss_tttt_rrrr_rrrr_ssss_pppp_nnnn, _ssss_tttt_rrrr_tttt_rrrr_nnnn_ssss - string manipulations
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _cccc_cccc [_f_l_a_g ...] _f_i_l_e ...  _----_llll_gggg_eeee_nnnn [_l_i_b_r_a_r_y ...]
  13.  
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_gggg_eeee_nnnn_...._hhhh_>>>>
  15.  
  16.      _iiii_nnnn_tttt _ssss_tttt_rrrr_ffff_iiii_nnnn_dddd _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_a_s_1_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_a_s_2_))))_;;;;
  17.  
  18.      _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_rrrr_ssss_pppp_nnnn _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_s_t_r_i_n_g_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_t_c_))))_;;;;
  19.  
  20.      _cccc_hhhh_aaaa_rrrr _**** _ssss_tttt_rrrr_tttt_rrrr_nnnn_ssss _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_s_t_r_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_o_l_d_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_n_e_w_,,,,
  21.          _cccc_hhhh_aaaa_rrrr _****_r_e_s_u_l_t_))))_;;;;
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      _ssss_tttt_rrrr_ffff_iiii_nnnn_dddd returns the offset of the second string, _a_s_2, if it is a
  25.      substring of string _a_s_1.
  26.  
  27.      _ssss_tttt_rrrr_rrrr_ssss_pppp_nnnn returns a pointer to the first character in the string to be
  28.      trimmed (all characters from the first character to the end of _s_t_r_i_n_g are
  29.      in _t_c).
  30.  
  31.      _ssss_tttt_rrrr_tttt_rrrr_nnnn_ssss transforms _ssss_tttt_rrrr and copies it into _r_e_s_u_l_t.  Any character that
  32.      appears in _o_l_d is replaced with the character in the same position in
  33.      _n_e_w.  The _n_e_w result is returned.
  34.  
  35. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  36.      _////_**** _ffff_iiii_nnnn_dddd _pppp_oooo_iiii_nnnn_tttt_eeee_rrrr _tttt_oooo _ssss_uuuu_bbbb_ssss_tttt_rrrr_iiii_nnnn_gggg _""""_hhhh_eeee_llll_llll_oooo_"""" _iiii_nnnn _aaaa_ssss_1111 _****_////
  37.      _iiii _==== _ssss_tttt_rrrr_ffff_iiii_nnnn_dddd_((((_aaaa_ssss_1111_,,,, _""""_hhhh_eeee_llll_llll_oooo_""""_))))_;;;;
  38.      _////_**** _tttt_rrrr_iiii_mmmm _jjjj_uuuu_nnnn_kkkk _ffff_rrrr_oooo_mmmm _eeee_nnnn_dddd _oooo_ffff _ssss_tttt_rrrr_iiii_nnnn_gggg _****_////
  39.      _ssss_2222 _==== _ssss_tttt_rrrr_rrrr_ssss_pppp_nnnn_((((_ssss_1111_,,,, _""""_****_????_####_$$$$_%%%%_""""_))))_;;;;
  40.      _****_ssss_2222 _==== _''''_\\\\_0000_''''_;;;;
  41.      _////_**** _tttt_rrrr_aaaa_nnnn_ssss_ffff_oooo_rrrr_mmmm _llll_oooo_wwww_eeee_rrrr _cccc_aaaa_ssss_eeee _tttt_oooo _uuuu_pppp_pppp_eeee_rrrr _cccc_aaaa_ssss_eeee _****_////
  42.      _aaaa_1111_[[[[_]]]] _==== _""""_aaaa_bbbb_cccc_dddd_eeee_ffff_gggg_hhhh_iiii_jjjj_kkkk_llll_mmmm_nnnn_oooo_pppp_qqqq_rrrr_ssss_tttt_uuuu_vvvv_wwww_xxxx_yyyy_zzzz_""""_;;;;
  43.      _aaaa_2222_[[[[_]]]] _==== _""""_AAAA_BBBB_CCCC_DDDD_EEEE_FFFF_GGGG_HHHH_IIII_JJJJ_KKKK_LLLL_MMMM_NNNN_OOOO_PPPP_QQQQ_RRRR_SSSS_TTTT_UUUU_VVVV_WWWW_XXXX_YYYY_ZZZZ_""""_;;;;
  44.      _ssss_2222 _==== _ssss_tttt_rrrr_tttt_rrrr_nnnn_ssss_((((_ssss_1111_,,,, _aaaa_1111_,,,, _aaaa_2222_,,,, _ssss_2222_))))_;;;;
  45.  
  46. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  47.      _ssss_tttt_rrrr_iiii_nnnn_gggg(3C)
  48.  
  49. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  50.      If the second string is not a substring of the first string _ssss_tttt_rrrr_ffff_iiii_nnnn_dddd
  51.      returns -1.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.